[Snyk] Upgrade stripe from 15.12.0 to 18.1.0 #141
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Snyk has created this PR to upgrade stripe from 15.12.0 to 18.1.0. See this package in npm: stripe See this project in Snyk: https://app.snyk.io/org/nerds-github/project/ef708957-d107-4807-bb9b-ffb67ea15337?utm_source=github&utm_medium=referral&page=upgrade-pr
Reviewer's GuideThis PR updates the Stripe SDK dependency in the dashboard app from v15.x to v18.x by modifying the package.json entry, ensuring the project uses the latest Stripe API client. Updated Class Diagram for Stripe.Invoice highlighting changes from v15.x to v18.1.0classDiagram
class Stripe.Invoice {
%% --- Illustrative New/Updated Fields in v18.x ---
+String amount_overpaid
+String confirmation_secret
+List~InvoicePayment~ payments
+String parent
+List~Tax~ total_taxes
+AutomaticTax automatic_tax
%% --- Illustrative Removed Fields from v15.x (now absent in v18.x) ---
%% String application_fee_amount (Removed in v18.0.0)
%% String charge (Removed in v18.0.0)
%% String payment_intent (Removed in v18.0.0)
%% String subscription (Removed in v18.0.0)
%% listUpcomingLines() (Removed in v18.0.0)
%% retrieveUpcoming() (Removed in v18.0.0)
}
class AutomaticTax {
+String provider %% New field in v18.1.0
}
Stripe.Invoice --o AutomaticTax : uses
Updated Class Diagram for Stripe.Account highlighting new fields in v18.1.0classDiagram
class Stripe.Account {
%% --- Illustrative New/Updated Fields in v18.1.0 ---
+BusinessProfile business_profile
+Company company
%% Person person (related, Person object now supports us_cfpb_data)
}
class BusinessProfile {
+String minority_owned_business_designation %% New field in v18.1.0
}
class Company {
+String registration_date %% New field in v18.1.0
}
Stripe.Account "1" --o "1" BusinessProfile : has
Stripe.Account "1" --o "1" Company : has
Updated Class Diagram for Stripe.Checkout.Session highlighting changes from v15.x to v18.1.0classDiagram
class Stripe.Checkout.Session {
%% --- Illustrative New/Updated Fields in v18.x ---
+PresentmentDetails presentment_details %% New in v18.0.0
+List~Item~ optional_items %% New in v18.0.0
+Permissions permissions %% New in v18.0.0
+WalletOptions wallet_options %% New in v18.1.0
+AutomaticTax automatic_tax %% Updated in v18.1.0
+CollectedInformation collected_information %% Became required in v18.0.0
%% --- Illustrative Removed Fields from v15.x (now absent in v18.x) ---
%% ShippingDetails shipping_details (Top-level field removed in v18.0.0)
}
class CollectedInformation {
+Address address %% Attribute: became required in v18.0.0
+String name %% Attribute: became required in v18.0.0
%% --- Illustrative Removed Fields from v15.x (now absent in v18.x) ---
%% String carrier (Removed from shipping_details within CollectedInformation in v18.0.0)
%% String phone (Removed from shipping_details within CollectedInformation in v18.0.0)
%% String tracking_number (Removed from shipping_details within CollectedInformation in v18.0.0)
}
class AutomaticTax {
+String provider %% New field in v18.1.0
}
class Permissions {
+boolean update_line_items %% New field in v18.0.0
+boolean update_shipping_details %% New field in v18.0.0
}
Stripe.Checkout.Session --o CollectedInformation
Stripe.Checkout.Session --o AutomaticTax
Stripe.Checkout.Session --o Permissions
Class Diagram: Removed Stripe Resources in v18.0.0classDiagram
class Stripe.SubscriptionItemUsageRecordSummary {
%% Class REMOVED in Stripe SDK v18.0.0
%% Previously had fields like: id, object, period, total_usage
}
class Stripe.SubscriptionItemUsageRecord {
%% Class REMOVED in Stripe SDK v18.0.0
%% Previously had fields like: id, object, quantity, subscription_item, timestamp
}
File-Level Changes
Tips and commandsInteracting with Sourcery
Customizing Your ExperienceAccess your dashboard to:
Getting Help
|
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Snyk has created this PR to upgrade stripe from 15.12.0 to 18.1.0.
ℹ️ Keep your dependencies up-to-date. This makes it easier to fix existing vulnerabilities and to more quickly identify and fix newly disclosed vulnerabilities when they affect your project.
The recommended version is 52 versions ahead of your current version.
The recommended version was released a month ago.
Release notes
Package name: stripe
This release changes the pinned API version to
2025-04-30.basil.minority_owned_business_designationonAccount.business_profile,AccountCreateParams.business_profile, andAccountUpdateParams.business_profileregistration_dateonAccount.company,AccountCreateParams.company,AccountUpdateParams.company, andTokenCreateParams.account.companyus_cfpb_dataonAccountCreatePersonParams,AccountUpdatePersonParams,Person, andTokenCreateParams.personverification_legal_entity_structure_mismatchon enumsAccount.future_requirements.errors[].code,Account.requirements.errors[].code,BankAccount.future_requirements.errors[].code,BankAccount.requirements.errors[].code,Capability.future_requirements.errors[].code,Capability.requirements.errors[].code,Person.future_requirements.errors[].code, andPerson.requirements.errors[].codetax_id_prohibitedon enumsInvoice.last_finalization_error.code,PaymentIntent.last_payment_error.code,SetupAttempt.setup_error.code,SetupIntent.last_setup_error.code, andStripeError.codetax_idonCharge.billing_details,ConfirmationToken.payment_method_preview.billing_details,ConfirmationTokenCreateParams.testHelpers.payment_method_data.billing_details,PaymentIntentConfirmParams.payment_method_data.billing_details,PaymentIntentCreateParams.payment_method_data.billing_details,PaymentIntentUpdateParams.payment_method_data.billing_details,PaymentMethod.billing_details,PaymentMethodCreateParams.billing_details,PaymentMethodUpdateParams.billing_details,SetupIntentConfirmParams.payment_method_data.billing_details,SetupIntentCreateParams.payment_method_data.billing_details, andSetupIntentUpdateParams.payment_method_data.billing_detailswallet_optionsonCheckout.SessionCreateParamsandCheckout.SessionprovideronCheckout.Session.automatic_tax,Invoice.automatic_tax, andQuote.automatic_taxaw_tin,az_tin,bd_bin,bf_ifu,bj_ifu,cm_niu,cv_nif,et_tin,kg_tin, andla_tinon enumsCheckout.Session.customer_details.tax_ids[].type,Invoice.customer_tax_ids[].type,Tax.Calculation.customer_details.tax_ids[].type,Tax.Transaction.customer_details.tax_ids[].type, andTaxId.typepayment_method_optionsonConfirmationTokenCreateParams.testHelpersinstallmentsonConfirmationToken.payment_method_options.cardaw_tin,az_tin,bd_bin,bf_ifu,bj_ifu,cm_niu,cv_nif,et_tin,kg_tin, andla_tinon enumsCustomerCreateParams.tax_id_data[].type,CustomerCreateTaxIdParams.type,InvoiceCreatePreviewParams.customer_details.tax_ids[].type,Tax.CalculationCreateParams.customer_details.tax_ids[].type, andTaxIdCreateParams.typecontextonEventaffirmon enumsInvoice.payment_settings.payment_method_types,InvoiceCreateParams.payment_settings.payment_method_types,InvoiceUpdateParams.payment_settings.payment_method_types,Subscription.payment_settings.payment_method_types,SubscriptionCreateParams.payment_settings.payment_method_types, andSubscriptionUpdateParams.payment_settings.payment_method_typesInvoiceLineItem.parent.subscription_item_details.subscriptionfromstringtostring | nullbillieonPaymentIntent.payment_method_options,PaymentIntentConfirmParams.payment_method_options,PaymentIntentCreateParams.payment_method_options, andPaymentIntentUpdateParams.payment_method_optionspixonPaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams, andPaymentMethodConfigurationklarnaonPaymentMethodDomainpending_reasononRefundTax.CalculationLineItem.referencefromstring | nulltostringaw,az,bd,bf,bj,cm,cv,et,in,kg,la, andphonTax.Registration.country_optionsandTax.RegistrationCreateParams.country_options2025-04-30.basilon enumWebhookEndpointCreateParams.api_versionSee the changelog for more details.
FxQuoteandPaymentIntentAmountDetailsLineItemcreate,list, andretrievemethods on resourceFxQuoteattach_payment_intentmethod on resourceInvoiceregistration_dateonAccount.company,AccountCreateParams.company,AccountUpdateParams.company, andTokenCreateParams.account.companycustomer_referenceandorder_referenceonChargeCaptureParams.payment_details,ChargeUpdateParams.payment_details,PaymentIntent.payment_details,PaymentIntentCaptureParams.payment_details,PaymentIntentConfirmParams.payment_details,PaymentIntentCreateParams.payment_details, andPaymentIntentUpdateParams.payment_detailstax_idonCharge.billing_details,ConfirmationToken.payment_method_preview.billing_details,ConfirmationTokenCreateParams.testHelpers.payment_method_data.billing_details,PaymentIntentConfirmParams.payment_method_data.billing_details,PaymentIntentCreateParams.payment_method_data.billing_details,PaymentIntentUpdateParams.payment_method_data.billing_details,PaymentMethod.billing_details,PaymentMethodCreateParams.billing_details,PaymentMethodUpdateParams.billing_details,SetupIntentConfirmParams.payment_method_data.billing_details,SetupIntentCreateParams.payment_method_data.billing_details,SetupIntentUpdateParams.payment_method_data.billing_details, andTreasury.OutboundPaymentCreateParams.destination_payment_method_data.billing_detailsprice_dataonCheckout.SessionUpdateParams.line_items[]Checkout.SessionUpdateParams.line_items[].quantityfromlongIntegertoemptyable(longInteger)scriptonCouponCreateParamsandCoupontypeonCouponfx_quote.expiredon enumEvent.typeaffirmon enumsInvoice.payment_settings.payment_method_types,InvoiceCreateParams.payment_settings.payment_method_types,InvoiceUpdateParams.payment_settings.payment_method_types,QuotePreviewInvoice.payment_settings.payment_method_types,Subscription.payment_settings.payment_method_types,SubscriptionCreateParams.payment_settings.payment_method_types, andSubscriptionUpdateParams.payment_settings.payment_method_typesfx_quoteonPaymentIntentConfirmParams,PaymentIntentCreateParams,PaymentIntentUpdateParams,PaymentIntent,TransferCreateParams, andTransferdiscount_amount,line_items,shipping, andtaxonPaymentIntent.amount_detailspixonPaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams, andPaymentMethodConfigurationus_cfpb_dataonPersonandTokenCreateParams.personpending_reasononRefundaw,az,bd,bj,et,kg,la, andphonTax.Registration.country_optionsandTax.RegistrationCreateParams.country_optionsfx_quote.expiredon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_eventsFxQuoteExpiredEventwith resourceFxQuoteSee the changelog for more details.
#2298 Update generated code for beta
Breaking changes
V2.MoneyManagement.ReceivedDebit.status_transitionsfroman objecttoan object | nullbank_accounts.local_uk,bank_accounts.wire_uk,cards_uk, andcrypto_wallets_v2from enumEventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capabilityAdditions
Privacy.RedactionJobRootObjects,Privacy.RedactionJobValidationError, andPrivacy.RedactionJobcancel,create,list,retrieve,run,update, andvalidatemethods on resourceRedactionJoblistandretrievemethods on resourceRedactionJobValidationErrorminority_owned_business_designationonAccount.business_profile,AccountCreateParams.business_profile, andAccountUpdateParams.business_profileverification_legal_entity_structure_mismatchon enumsAccount.future_requirements.errors[].code,Account.requirements.errors[].code,AccountCapability.future_requirements.errors[].code,AccountCapability.requirements.errors[].code,AccountPerson.future_requirements.errors[].code,AccountPerson.requirements.errors[].code,BankAccount.future_requirements.errors[].code, andBankAccount.requirements.errors[].codeexport_tax_transactionsandpayment_disputesonAccountSessionCreateParams.componentstax_id_prohibitedon enumsInvoice.last_finalization_error.code,PaymentIntent.last_payment_error.code,QuotePreviewInvoice.last_finalization_error.code,SetupAttempt.setup_error.code,SetupIntent.last_setup_error.code, andStripeError.codefixed_term_loanon enumCapital.FinancingOffer.typewallet_optionsonCheckout.SessionCreateParamsandCheckout.Sessionprivacy.redaction_job.canceled,privacy.redaction_job.created,privacy.redaction_job.ready,privacy.redaction_job.succeeded, andprivacy.redaction_job.validation_erroron enumEvent.typeklarnaonPaymentMethodDomainTax.CalculationLineItem.referencefromstring | nulltostringinonTax.Registration.country_optionsandTax.RegistrationCreateParams.country_optionsprivacy.redaction_job.canceled,privacy.redaction_job.created,privacy.redaction_job.ready,privacy.redaction_job.succeeded, andprivacy.redaction_job.validation_erroron enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_events#2300 Handle external_resource field
external_accountfield inExternalAccountsCreateParamsfrom astringto a union type.See the changelog for more details.
#2288 Update generated code for beta
This release changes the pinned API version to
2025-03-31.previewBreaking Changes
amount_overpaidonInvoicePaymentout_of_band_paymentandpayment_recordfrom enumInvoicePayment.payment.typeinterchange_fees,net_total,network_fees, andtransaction_volumeonIssuing.Settlementbilling_thresholdsonQuotePreviewSubscriptionSchedule.default_settings,QuotePreviewSubscriptionSchedule.phases[].items[], andQuotePreviewSubscriptionSchedule.phases[]coupononQuotePreviewSubscriptionSchedule.phases[]valueonTerminal.Reader.action.collect_inputs.inputs[].selection.choices[],Terminal.Reader.action.collect_inputs.inputs[].selection, andTerminal.ReaderCollectInputsParams.inputs[].selection.choices[]Checkout.Session.permissions.updateto be optionalInvoicePayment.is_defaultfromboolean | nulltobooleanInvoice.amount_overpaidandQuotePreviewInvoice.amount_overpaidto be requiredPaymentAttemptRecord.payment_method_details.typeandPaymentRecord.payment_method_details.typefromliteral('custom')tostringPaymentAttemptRecord.payment_recordfromstringtostring | nullPaymentAttemptRecord.payment_method_details.customandPaymentRecord.payment_method_details.customto be optionalPaymentRecordReportPaymentParams.payment_referenceto be optionalPaymentRecord.latest_payment_attempt_recordfromstringtostring | nullAdditions
BalanceSettingsretrieveandupdatemethods on resourceBalanceSettingscreate,del,list,retrieve, andupdatemethods on a newExternalAccountServiceclass to access cards and bank accounts made available in the new pathv1/external_accounts. Access this viaStripeClient.externalAccountsstripe_balance_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilitiescustomer_accountonBilling.CreditBalanceSummaryRetrieveParams,Billing.CreditBalanceSummary,Billing.CreditBalanceTransactionListParams,Billing.CreditGrantCreateParams,Billing.CreditGrantListParams,Billing.CreditGrant,BillingPortal.SessionCreateParams,BillingPortal.Session,Checkout.SessionCreateParams,Checkout.SessionListParams,Checkout.Session,ConfirmationToken.payment_method_preview,CreditNoteListParams,CreditNote,CustomerBalanceTransaction,CustomerCashBalanceTransaction,CustomerCashBalance,CustomerPaymentMethod,CustomerSessionCreateParams,CustomerSession,CustomerTaxId.owner,CustomerTaxId,Customer,Discount,FinancialConnections.Account.account_holder,FinancialConnections.AccountListParams.account_holder,FinancialConnections.Session.account_holder,FinancialConnections.SessionCreateParams.account_holder,InvoiceCreateParams,InvoiceCreatePreviewParams,InvoiceItemCreateParams,InvoiceItemListParams,InvoiceItem,InvoiceListParams,Invoice,PaymentIntentCreateParams,PaymentIntentListParams,PaymentIntentUpdateParams,PaymentIntent,PaymentMethodAttachParams,PaymentMethod,PromotionCodeCreateParams,PromotionCodeListParams,PromotionCode,QuoteCreateParams,QuoteListParams,QuotePreviewInvoice,QuotePreviewSubscriptionSchedule,QuoteUpdateParams,Quote,SetupAttempt,SetupIntentCreateParams,SetupIntentListParams,SetupIntentUpdateParams,SetupIntent,SubscriptionCreateParams,SubscriptionListParams,SubscriptionScheduleCreateParams,SubscriptionScheduleListParams,SubscriptionSchedule,Subscription,TaxId.owner,TaxIdCreateParams.owner,TaxIdListParams.owner, andTaxIdstripe_balanceonCharge.payment_method_details,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,CustomerPaymentMethod,PaymentAttemptRecord.payment_method_details,PaymentIntent.payment_method_options,PaymentIntentConfirmParams.payment_method_data,PaymentIntentConfirmParams.payment_method_options,PaymentIntentCreateParams.payment_method_data,PaymentIntentCreateParams.payment_method_options,PaymentIntentUpdateParams.payment_method_data,PaymentIntentUpdateParams.payment_method_options,PaymentMethodCreateParams,PaymentMethod,PaymentRecord.payment_method_details,SetupAttempt.payment_method_details,SetupIntentConfirmParams.payment_method_data,SetupIntentCreateParams.payment_method_data, andSetupIntentUpdateParams.payment_method_dataupdate_line_itemsandupdate_shipping_detailsonCheckout.Session.permissionsandCheckout.SessionCreateParams.permissionsprovideronCheckout.Session.automatic_tax,Invoice.automatic_tax,Quote.automatic_tax, andQuotePreviewInvoice.automatic_taxtax_calculation_referenceonCreditNoteLineItem,CreditNotePreviewLines,InvoiceLineItem,LineItem,PaymentLinkLineItem,QuoteComputedUpfrontLineItems,QuoteLineItem, andSessionLineItempayment_method_optionsonConfirmationTokenCreateParams.testHelpersinstallmentsonConfirmationToken.payment_method_options.cardcontextonEventrelated_customer_accountonIdentity.VerificationSession,identity.VerificationSessionCreateParams, andidentity.VerificationSessionListParamsnetwork_dataonIssuing.DisputeSettlementDetailinterchange_fees_amount,net_total_amount,network_fees_amount,other_fees_amount,other_fees_count, andtransaction_amountonIssuing.Settlementreported_byonPaymentAttemptRecordach_credit_transfer,ach_debit,acss_debit,affirm,afterpay_clearpay,alipay,alma,amazon_pay,au_becs_debit,bacs_debit,bancontact,blik,boleto,card_present,card,cashapp,customer_balance,eps,fpx,giropay,gopay,grabpay,id_bank_transfer,ideal,interac_present,kakao_pay,klarna,konbini,kr_card,link,mb_way,mobilepay,multibanco,naver_pay,nz_bank_account,oxxo,p24,pay_by_bank,payco,paynow,paypal,payto,pix,promptpay,qris,rechnung,revolut_pay,samsung_pay,satispay,sepa_credit_transfer,sepa_debit,shopeepay,sofort,stripe_account,swish,twint,us_bank_account,wechat_pay,wechat, andziponPaymentAttemptRecord.payment_method_detailsandPaymentRecord.payment_method_detailspayout_methodonPayoutCreateParamsandPayoutconfirmation_secret,parent, andtotal_taxesonQuotePreviewInvoiceforwarding_api_retryable_upstream_error,setup_intent_mobile_wallet_unsupported,v2_account_disconnection_unsupported, andv2_account_missing_configurationon enumQuotePreviewInvoice.last_finalization_error.codeklarna,nz_bank_account, andstripe_balanceon enumQuotePreviewInvoice.payment_settings.payment_method_typesidandtextonTerminal.Reader.action.collect_inputs.inputs[].selection.choices[],Terminal.Reader.action.collect_inputs.inputs[].selection, andTerminal.ReaderCollectInputsParams.inputs[].selection.choices[]New APIs for Money CardManagement
V2.FinancialAddressCreditSimulation,V2.FinancialAddressGeneratedMicrodeposits,V2.MoneyManagement.Adjustment,V2.MoneyManagement.FinancialAccount,V2.MoneyManagement.FinancialAddress,V2.MoneyManagement.InboundTransfer,V2.MoneyManagement.OutboundPaymentQuote,V2.MoneyManagement.OutboundPayment,V2.MoneyManagement.OutboundSetupIntent,V2.MoneyManagement.OutboundTransfer,V2.MoneyManagement.PayoutMethod,V2.MoneyManagement.PayoutMethodsBankAccountSpec,V2.MoneyManagement.ReceivedCredit,V2.MoneyManagement.ReceivedDebit,V2.MoneyManagement.TransactionEntry, andV2.MoneyManagement.Transactioncreatemethod on resourceV2.MoneyManagement.OutboundPaymentQuotelistandretrievemethods on resourcesV2.MoneyManagement.Adjustment,V2.MoneyManagement.FinancialAccount,V2.MoneyManagement.ReceivedCredit,V2.MoneyManagement.ReceivedDebit,V2.MoneyManagement.TransactionEntry, andV2.MoneyManagement.Transactioncreate,list, andretrievemethods on resourcesV2.MoneyManagement.FinancialAddressandV2.MoneyManagement.InboundTransfercancel,create,list, andretrievemethods on resourcesV2.MoneyManagement.OutboundPaymentandV2.MoneyManagement.OutboundTransferarchive,list,retrieve, andunarchivemethods on resourceV2.MoneyManagement.PayoutMethodcancel,create,list,retrieve, andupdatemethods on resourceV2.MoneyManagement.OutboundSetupIntentretrievemethod on resourceV2.MoneyManagement.PayoutMethodsBankAccountSpecaccount_number,fedwire_routing_number, androuting_numberon enuminvalid_payment_method.invalid_paramV2MoneyManagementFinancialAccountCreatedEventwith related objectV2.MoneyManagement.FinancialAccountV2MoneyManagementFinancialAddressActivatedEventandV2MoneyManagementFinancialAddressFailedEventwith related objectV2.MoneyManagement.FinancialAddressV2MoneyManagementInboundTransferAvailableEvent,V2MoneyManagementInboundTransferBankDebitFailedEvent,V2MoneyManagementInboundTransferBankDebitProcessingEvent,V2MoneyManagementInboundTransferBankDebitQueuedEvent,V2MoneyManagementInboundTransferBankDebitReturnedEvent, andV2MoneyManagementInboundTransferBankDebitSucceededEventwith related objectV2.MoneyManagement.InboundTransferV2MoneyManagementOutboundPaymentCanceledEvent,V2MoneyManagementOutboundPaymentCreatedEvent,V2MoneyManagementOutboundPaymentFailedEvent,V2MoneyManagementOutboundPaymentPostedEvent, andV2MoneyManagementOutboundPaymentReturnedEventwith related objectV2.MoneyManagement.OutboundPaymentV2MoneyManagementOutboundTransferCanceledEvent,V2MoneyManagementOutboundTransferCreatedEvent,V2MoneyManagementOutboundTransferFailedEvent,V2MoneyManagementOutboundTransferPostedEvent, andV2MoneyManagementOutboundTransferReturnedEventwith related objectV2.MoneyManagement.OutboundTransferV2MoneyManagementReceivedCreditAvailableEvent,V2MoneyManagementReceivedCreditFailedEvent,V2MoneyManagementReceivedCreditReturnedEvent, andV2MoneyManagementReceivedCreditSucceededEventwith related objectV2.MoneyManagement.ReceivedCreditV2MoneyManagementReceivedDebitCanceledEvent,V2MoneyManagementReceivedDebitFailedEvent,V2MoneyManagementReceivedDebitPendingEvent,V2MoneyManagementReceivedDebitSucceededEvent, andV2MoneyManagementReceivedDebitUpdatedEventwith related objectV2.MoneyManagement.ReceivedDebitAlreadyCanceledError,BlockedByStripeError,ControlledByDashboardError,FeatureNotEnabledError,FinancialAccountNotOpenError,InsufficientFundsError,InvalidPayoutMethodError,NotCancelableError, andRecipientNotNotifiableErrorNew APIs for Accounts v2 in private preview
See SaaS platform payments with subscription billing using Accounts v2
V2.Core.AccountLink,V2.Core.Account,V2.Core.Person,V2.Core.Vault.GbBankAccount,V2.Core.Vault.UsBankAccountclose,create,list,retrieve, andupdatemethods on resourceV2.Core.Accountcreatemethod on resourceV2.Core.AccountLinkacknowledge_confirmation_of_payee,archive,create,initiate_confirmation_of_payee, andretrievemethods on resourceV2.Core.Vault.GbBankAccountarchive,create,retrieve, andupdatemethods on resourceV2.Core.Vault.UsBankAccountV2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationCustomerUpdatedEvent,V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationMerchantUpdatedEvent,V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationRecipientUpdatedEvent,V2CoreAccountIncludingIdentityUpdatedEvent, andV2CoreAccountIncludingRequirementsUpdatedEventV2CoreAccountLinkCompletedEventwith related objectV2.Core.AccountLinkV2CoreAccountPersonCreatedEvent,V2CoreAccountPersonDeletedEvent, andV2CoreAccountPersonUpdatedEventwith related objectV2.Core.PersonChanges
Billing.CreditBalanceSummaryRetrieveParams.customer,Billing.CreditBalanceTransactionListParams.customer,Billing.CreditGrantCreateParams.customer,BillingPortal.SessionCreateParams.customer,CustomerSessionCreateParams.customer,InvoiceItemCreateParams.customer,PaymentMethodAttachParams.customer, andSubscriptionCreateParams.customerto be optionalCreditNote.refundsto be requiredPaymentAttemptRecord.payment_method_details.customandPaymentRecord.payment_method_details.customfromPaymentsPrimitivesPaymentRecordsResourcePaymentMethodCustomDetails | nulltoPaymentsPrimitivesPaymentRecordsResourcePaymentMethodCustomDetailsOrderCreateParams.payment.settings.payment_method_options.wechat_pay.clientandOrderUpdateParams.payment.settings.payment_method_options.wechat_pay.clientto be optionalSee the changelog for more details.
#2279 Support for APIs in the new API version 2025-03-31.basil
This release changes the pinned API version to
2025-03-31.basil.Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.
SubscriptionItemUsageRecordSummaryandSubscriptionItemUsageRecordlistUpcomingLinesandretrieveUpcomingmethods on resourceInvoicecreateUsageRecordandlistUsageRecordSummariesmethods on resourceSubscriptionItemsinvoiceonChargeandPaymentIntentshipping_detailsonCheckout.Sessioncarrier,phone, andtracking_numberonCheckout.Session.collected_information.shipping_details. Makenameandaddressrequired instead of optional.refundonCreditNoteCreateParams,CreditNoteListPreviewLineItemsParams,CreditNotePreviewParams, andCreditNotetax_amountsonCreditNoteLineItem,CreditNote, andInvoiceLineItemamount_excluding_taxandunit_amount_excluding_taxonCreditNoteLineItemandInvoiceLineItemcoupononCustomerCreateParams,CustomerUpdateParams,InvoiceCreatePreviewParams.schedule_details.phases[],InvoiceCreatePreviewParams,SubscriptionCreateParams,SubscriptionSchedule.phases[],SubscriptionScheduleCreateParams.phases[],SubscriptionScheduleUpdateParams.phases[], andSubscriptionUpdateParamspromotion_codeonCustomerCreateParams,CustomerUpdateParams,SubscriptionCreateParams, andSubscriptionUpdateParamspriceonInvoiceAddLinesParams.lines[],InvoiceItemCreateParams,InvoiceItemUpdateParams,InvoiceItem,InvoiceLineItemUpdateParams,InvoiceLineItem, andInvoiceUpdateLinesParams.lines[]. Usepricing` instead.billing_thresholdsonInvoiceCreatePreviewParams.schedule_details.phases[].items[],InvoiceCreatePreviewParams.schedule_details.phases[],InvoiceCreatePreviewParams.subscription_details.items[],SubscriptionCreateParams.items[],SubscriptionCreateParams,SubscriptionItemCreateParams,SubscriptionItemUpdateParams,SubscriptionItem,SubscriptionSchedule.default_settings,SubscriptionSchedule.phases[].items[],SubscriptionSchedule.phases[],SubscriptionScheduleCreateParams.default_settings,SubscriptionScheduleCreateParams.phases[].items[],SubscriptionScheduleCreateParams.phases[],SubscriptionScheduleUpdateParams.default_settings,SubscriptionScheduleUpdateParams.phases[].items[],SubscriptionScheduleUpdateParams.phases[],SubscriptionUpdateParams.items[],SubscriptionUpdateParams, andSubscriptionapplication_fee_amount,charge,paid_out_of_band,paid,payment_intent,quote,subscription,subscription_details,subscription_proration_date,tax,total_tax_amounts, andtransfer_dataonInvoicediscountonInvoiceandSubscriptioninvoice_item,proration_details,proration,tax_rates, andtypeonInvoiceLineItemplanandsubscription_itemonInvoiceItemandInvoiceLineItemunit_amountonInvoiceItemCreateParams,InvoiceItemUpdateParams, andInvoiceItemsubscriptionandunit_amount_decimalonInvoiceItemnaver_payonPaymentMethodUpdateParamsaggregate_usageonPlanCreateParams,Plan,Price.recurring, andPriceCreateParams.recurringcurrent_period_endandcurrent_period_startonSubscriptionpagehas been removed from all V2 list method params (e.g.EventService.list()); use the auto paginator or thenext_page_urlandprevious_page_urlfields instead (more info)Changes
Checkout.Session.collected_informationto be requiredCheckout.Session.collected_information.shipping_detailsto be requiredCheckout.Session.collected_information.shipping_details.addressto be requiredCheckout.Session.collected_information.shipping_details.nameto be requiredPaymentIntentConfirmParams.payment_method_options.wechat_pay.client,PaymentIntentCreateParams.payment_method_options.wechat_pay.client, andPaymentIntentUpdateParams.payment_method_options.wechat_pay.clientto be optionalpolitical_exposureon resourcesPersonandTokenand paramsToken.CreateParamsfrom string to enum("existing" | "none")Additions
InvoicePaymentlistandretrievemethods on resourceInvoicePaymentbillie_payments,nz_bank_account_becs_debit_payments, andsatispay_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilitieshosted_payment_method_saveonAccount.settings.invoicesandAccountUpdateParams.settings.invoicesinvoicesonAccountCreateParams.settingsinformation_missing,invalid_signator,verification_failed_authorizer_authority, andverification_rejected_ownership_exemption_reasonon enumsAccount.future_requirements.errors[].code,Account.requirements.errors[].code,AccountCapability.future_requirements.errors[].code,AccountCapability.requirements.errors[].code,AccountPerson.future_requirements.errors[].code,AccountPerson.requirements.errors[].code,BankAccount.future_requirements.errors[].code, andBankAccount.requirements.errors[].codeforwarding_api_retryable_upstream_errorandsetup_intent_mobile_wallet_unsupportedon enumsInvoice.last_finalization_error.code,PaymentIntent.last_payment_error.code,SetupAttempt.setup_error.code,SetupIntent.last_setup_error.code, andStripeError.codestripe_balance_payment_debit_reversalandstripe_balance_payment_debiton enumBalanceTransaction.typelaston enumsBilling.Meter.default_aggregation.formulaandBilling.MeterCreateParams.default_aggregation.formulapresentment_detailsonCharge,Checkout.Session,PaymentIntent, andRefundbillieandsatispayonCharge.payment_method_details,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,CustomerPaymentMethod,PaymentIntentConfirmParams.payment_method_data,PaymentIntentCreateParams.payment_method_data,PaymentIntentUpdateParams.payment_method_data,PaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams,PaymentMethodConfiguration,PaymentMethodCreateParams,PaymentMethod,SetupIntentConfirmParams.payment_method_data,SetupIntentCreateParams.payment_method_data, andSetupIntentUpdateParams.payment_method_datanz_bank_accountonCharge.payment_method_details,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,CustomerPaymentMethod,Mandate.payment_method_details,PaymentIntent.payment_method_options,PaymentIntentConfirmParams.payment_method_data,PaymentIntentConfirmParams.payment_method_options,PaymentIntentCreateParams.payment_method_data,PaymentIntentCreateParams.payment_method_options,PaymentIntentUpdateParams.payment_method_data,PaymentIntentUpdateParams.payment_method_options,PaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams,PaymentMethodConfiguration,PaymentMethodCreateParams,PaymentMethod,SetupAttempt.payment_method_details,SetupIntentConfirmParams.payment_method_data,SetupIntentCreateParams.payment_method_data, andSetupIntentUpdateParams.payment_method_dataoptional_itemsonCheckout.SessionCreateParams,Checkout.Session,PaymentLinkCreateParams, andPaymentLinkpermissionsonCheckout.SessionCreateParamsandCheckout.Sessionbillieandsatispayon enumCheckout.SessionCreateParams.payment_method_typescustomon enumsCheckout.Session.ui_modeandCheckout.SessionCreateParams.ui_modeshipping_optionsonCheckout.SessionUpdateParamsbillie,nz_bank_account, andsatispayon enumsConfirmationTokenCreateParams.testHelpers.payment_method_data.type,PaymentIntentConfirmParams.payment_method_data.type,PaymentIntentCreateParams.payment_method_data.type,PaymentIntentUpdateParams.payment_method_data.type,SetupIntentConfirmParams.payment_method_data.type,SetupIntentCreateParams.payment_method_data.type, andSetupIntentUpdateParams.payment_method_data.typebuyer_idonConfirmationToken.payment_method_preview.naver_pay,CustomerPaymentMethod.naver_pay, andPaymentMethod.naver_paybillie,nz_bank_account, andsatispayon enumsConfirmationToken.payment_method_preview.type,CustomerPaymentMethod.type, andPaymentMethod.typerefundsonCreditNoteCreateParams,CreditNoteListPreviewLineItemsParams,CreditNotePreviewParams, andCreditNotetotal_taxesonCreditNoteandInvoicetaxesonCreditNoteLineItemandInvoiceLineItemcheckout_sessiononCustomerBalanceTransactioncheckout_session_subscription_payment_canceledandcheckout_session_subscription_paymenton enumCustomerBalanceTransaction.typebillie,nz_bank_account, andsatispayon enumsCustomerPaymentMethodListParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.typeinvoice.overpaidon enumEvent.typeklarnaandnz_bank_accounton enumsInvoice.payment_settings.payment_method_types,InvoiceCreateParams.payment_settings.payment_method_types,InvoiceUpdateParams.payment_settings.payment_method_types,Subscription.payment_settings.payment_method_types,SubscriptionCreateParams.payment_settings.payment_method_types, andSubscriptionUpdateParams.payment_settings.payment_method_typespricingonInvoiceAddLinesParams.lines[],InvoiceItemCreateParams,InvoiceItemUpdateParams,InvoiceItem,InvoiceLineItemUpdateParams,InvoiceLineItem, andInvoiceUpdateLinesParams.lines[]taxability_reasononInvoiceAddLinesParams.lines[].tax_amounts[],InvoiceLineItemUpdateParams.tax_amounts[], andInvoiceUpdateLinesParams.lines[].tax_amounts[]jurisdiction_levelonInvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data,InvoiceLineItemUpdateParams.tax_amounts[].tax_rate_data, andInvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_dataamount_overpaid,confirmation_secret, andpaymentsonInvoiceparentonInvoiceItem,InvoiceLineItem, andInvoiceexpiredon enumsIssuing.Authorization.statusandIssuing.AuthorizationListParams.statusnetwork_fallbackon enumIssuing.Authorization.request_history[].reasonnaver_payonMandate.payment_method_detailsandSetupAttempt.payment_method_detailssetup_future_usageonPaymentIntent.payment_method_options.naver_pay,PaymentIntentConfirmParams.payment_method_options.naver_pay,PaymentIntentCreateParams.payment_method_options.naver_pay, andPaymentIntentUpdateParams.payment_method_options.naver_payexpiredon enumPaymentIntent.cancellation_reasondefault_valueonPaymentLink.custom_fields[].dropdown,PaymentLink.custom_fields[].numeric,PaymentLink.custom_fields[].text,PaymentLinkCreateParams.custom_fields[].dropdown,PaymentLinkCreateParams.custom_fields[].numeric,PaymentLinkCreateParams.custom_fields[].text,PaymentLinkUpdateParams.custom_fields[].dropdown,PaymentLinkUpdateParams.custom_fields[].numeric, andPaymentLinkUpdateParams.custom_fields[].textbillieandsatispayon enumsPaymentLink.payment_method_types,PaymentLinkCreateParams.payment_method_types, andPaymentLinkUpdateParams.payment_method_typesnz_bank_transferonRefund.destination_detailscanceledon enumReview.closed_reasoncurrent_period_endandcurrent_period_startonSubscriptionItemwifionTerminal.ConfigurationCreateParams,Terminal.ConfigurationUpdateParams, andTerminal.Configurationinvoice.overpaidon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_events2025-03-01.dashboardand2025-03-31.basilon enumWebhookEndpointCreateParams.api_versionSee the changelog for more details.
#2271 Beta SDK updates between Open API versions 1473 and 1505
succeed_input_collectionandtimeout_input_collectiontest helper methods on resourceTerminal.ReaderAccount.risk_controls.rejected_reasonfrom enum to enum | nullCheckout.Session.collected_information.shipping_detailsandCheckout.Session.collected_informationto be requiredtarget_dateonOrder.payment.settings.payment_method_options.acss_debit,Order.payment.settings.payment_method_options.sepa_debit,OrderCreateParams.payment.settings.payment_method_options.acss_debit,OrderCreateParams.payment.settings.payment_method_options.sepa_debit,OrderUpdateParams.payment.settings.payment_method_options.acss_debit, andOrderUpdateParams.payment.settings.payment_method_options.sepa_debit#2272 Merge master
See the changelog for more details.
pricesonBilling.CreditBalanceSummaryRetrieveParams.filter.applicability_scope,Billing.CreditGrant.applicability_config.scope, andBilling.CreditGrantCreateParams.applicability_config.scopeBilling.CreditBalanceSummaryRetrieveParams.filter.applicability_scope.price_type,Billing.CreditGrant.applicability_config.scope.price_type, andBilling.CreditGrantCreateParams.applicability_config.scope.price_typeto be optionalpriorityonBilling.CreditGrantCreateParamsandBilling.CreditGranttarget_dateonCheckout.Session.payment_method_options.acss_debit,Checkout.Session.payment_method_options.au_becs_debit,Checkout.Session.payment_method_options.bacs_debit,Checkout.Session.payment_method_options.sepa_debit,Checkout.Session.payment_method_options.us_bank_account,Checkout.SessionCreateParams.payment_method_options.acss_debit,Checkout.SessionCreateParams.payment_method_options.au_becs_debit,Checkout.SessionCreateParams.payment_method_options.bacs_debit,Checkout.SessionCreateParams.payment_method_options.sepa_debit,Checkout.SessionCreateParams.payment_method_options.us_bank_account,PaymentIntent.payment_method_options.acss_debit,PaymentIntent.payment_method_options.au_becs_debit,PaymentIntent.payment_method_options.bacs_debit,PaymentIntent.payment_method_options.sepa_debit,PaymentIntent.payment_method_options.us_bank_account,PaymentIntentConfirmParams.payment_method_options.acss_debit,PaymentIntentConfirmParams.payment_method_options.au_becs_debit,PaymentIntentConfirmParams.payment_method_options.bacs_debit,PaymentIntentConfirmParams.payment_method_options.sepa_debit,PaymentIntentConfirmParams.payment_method_options.us_bank_account,PaymentIntentCreateParams.payment_method_options.acss_debit,PaymentIntentCreateParams.payment_method_options.au_becs_debit,PaymentIntentCreateParams.payment_method_options.bacs_debit,PaymentIntentCreateParams.payment_method_options.sepa_debit,PaymentIntentCreateParams.payment_method_options.us_bank_account,PaymentIntentUpdateParams.payment_method_options.acss_debit,PaymentIntentUpdateParams.payment_method_options.au_becs_debit,PaymentIntentUpdateParams.payment_method_options.bacs_debit,PaymentIntentUpdateParams.payment_method_options.sepa_debit, andPaymentIntentUpdateParams.payment_method_options.us_bank_accountrestrictionsonCheckout.Session.payment_method_options.cardandCheckout.SessionCreateParams.payment_method_options.cardcollected_informationonCheckout.SessionUpdateParamsandCheckout.SessionCheckout.Session.discounts,Refund.destination_details.blik.network_decline_code, andRefund.destination_details.swish.network_decline_codeto be requiredmetadataonProductCreateParams.default_price_dataTokenCreateParams.person.political_exposurefromstringtoenum('existing'|'none')2025-02-24.acaciaon enumWebhookEndpointCreateParams.api_versionOPENAPI_VERSIONinto npm bundleSee the changelog for more details.
rejected_reasononAccount.risk_controlsproduct_tax_code_selectoronAccountSessionCreateParams.componentspricesonBilling.CreditBalanceSummaryRetrieveParams.filter.applicability_scope,Billing.CreditGrant.applicability_config.scope, andBilling.CreditGrantCreateParams.applicability_config.scopeBilling.CreditGrant.applicability_config.scope.price_type,Checkout.Session.collected_information.business_name,Checkout.Session.collected_information.email,Checkout.Session.collected_information.phone,Checkout.Session.collected_information.shipping_details, andCheckout.Session.collected_information.tax_idsto be optionalbrand_productonCharge.payment_method_details.amazon_pay.funding.cardandCharge.payment_method_details.revolut_pay.funding.cardrestrictionsonCheckout.Session.payment_method_options.cardandCheckout.SessionCreateParams.payment_method_options.cardCheckout.Session.discountsto be requiredTokenCreateParams.person.political_exposurefromstringtoenum('existing'|'none')See the changelog for more details.
closemethod on resourceTreasury.FinancialAccountSummary by Sourcery- Bump the stripe package version from ^15.8.0 to ^18.1.0 in dashboard/package.json
Chores: